-- ********************************************************************
-- CISCO-PSD-CLIENT-MIB.my: MIB file for PSD
--
-- August 2005, Suma Marutirao Sutar
--
-- Copyright (c), 2005 by Cisco Systems, Inc.
-- All rights reserved.
-- ********************************************************************
-- $Endlog$CISCO-PSD-CLIENT-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,NOTIFICATION-TYPE,
Counter32,Integer32FROM SNMPv2-SMI
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB
RowStatus,TruthValueFROM SNMPv2-TC
InetAddressType,InetAddressFROM INET-ADDRESS-MIB
MODULE-COMPLIANCE,OBJECT-GROUP,NOTIFICATION-GROUPFROM SNMPv2-CONF
ciscoMgmt
FROM CISCO-SMI;
ciscoPsdClientMIB MODULE-IDENTITYLAST-UPDATED"200508241800Z"ORGANIZATION"Cisco Systems, Inc."CONTACT-INFO" Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-gprs@cisco.com"DESCRIPTION"This MIB module manages the client side
functionality of the Persistent Storage Device(PSD).
This MIB instrumentation is for configuring
data-store(PSD client) feature on GGSN and monitoring
the state of the PSD server(up/down/full).
The Cisco Persistent Storage Device(PSD) is an
extension to existing storage on the Cisco Content
Services Gateway(CSG).
The GGSN currently allows sending of the CDRs to an
active CG, while allowing up to two standby CG's to
be configured. When all the configured CG's become
unavailable, the CDRs get stored at the GGSN and
start using up GGSN resources such as memory. As the
amount of memory is limited on GGSN and failure of
GGSN shall lead to losing these stored CDRs.
Using PSD as temporary storage, shall avoid losses
due to these problems. When all the configured CG's
are unavailable, GGSN needs to backup the live closed
CDR's to a PSD. When any of the CG's shall become
available, GGSN shall retrieve the stored CDR's
automatically from the PSD and forwards them to the
active CG.
PSD supports the charging protocol(GTP'), version 0
with a few private extensions, which is used to
facilitate the required functionality via UDP.
Acronyms and terms:
CDR Call Detail Record
CID Charging Identification
CG Charging Gateway
CGF Charging Gateway Functionality
DS Data-Store
ETSI European Telecommunications Standards
Institute
Ga Name of the interface between SGSN/GGSN and
CG
Gi Name of the interface between GGSN and PDN
Gn Name of the interface between GGSN and SGSN
G-CDR Gateway GPRS Support Node-Call Detail Record
GGSN Gateway GPRS Support Node
GPRS General Packet Radio Service
GSM Global System for Mobile communication
GTP GPRS Tunneling Protocol
GTP' GTP enhanced for charging
IE Information Element
MS Mobile Station
PDN Packet Data Network
PDP Packet Data Protocol
SGSN Serving GPRS support Node
TOS Type of Service.
PSD Persistence Storage Device."-- REFERENCE
-- "[1] GSM 09.60: Digital cellular telecommunication
-- system (Phase 2+); General Packet Radio Service
-- (GPRS); GPRS Tunneling Protocol (GTP) across
-- Gn and Gp Interface, ETSI, (V7.3.0)
-- [2] GSM 12.15: 'Digital Cellular telecommunications
-- system (Phase 2+); General Packet Radio Service
-- (GPRS); Charging in GPRS', ETSI, (V7.2.1)
-- [3] 3GPP; Universal Mobile Telecommunications System
-- (UMTS);Telecommunication Management;Charging and
-- billing;3G call and event data for Packet
-- Switched(PS) domain.TS 32.015 version 3.8.0
-- (Release 1999)."REVISION"200508241800Z"DESCRIPTION"Initial version of this MIB module."::={ciscoMgmt 495}-- Notification DefinitionsciscoPsdClientMIBNotifs OBJECTIDENTIFIER
::={ ciscoPsdClientMIB 0}-- Object definitionsciscoPsdClientMIBObjects OBJECTIDENTIFIER::={ ciscoPsdClientMIB 1}ciscoPsdClientStatistics OBJECTIDENTIFIER::={ ciscoPsdClientMIBObjects 1}ciscoPsdClientNotifMgmt OBJECTIDENTIFIER::={ ciscoPsdClientMIBObjects 2}
ciscoPsdClientConfigurations OBJECTIDENTIFIER::={ ciscoPsdClientMIBObjects 3}ciscoPsdClientNotifInfo OBJECTIDENTIFIER::={ ciscoPsdClientMIBObjects 4}-- Conformances definitionsciscoPsdClientMIBConform OBJECTIDENTIFIER::={ ciscoPsdClientMIB 2}--
-- Statistics
--cPsdClientDSWriteReq OBJECT-TYPESYNTAXCounter32
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of Data Record Transfer request (for write)
messages sent to the PSD server.
This counter is incremented when the FIFO write request
is sent to the PSD server from the client."::={ ciscoPsdClientStatistics 1}cPsdClientDSReadReq OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrent
DESCRIPTION"The number of Data Record Transfer request (for read)
messages sent to PSD server.
This counter is incremented when the FIFO read request
message is sent to PSD server."::={ ciscoPsdClientStatistics 2}cPsdClientDSRdWrRetrans OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of Data Record Transfer Request
(retransmission) messages sent to the PSD server.
The PSD does not differentiate between a retransmission
and original request. So, this counter together with
the above two counters cPsdClientDSReadReq/
cPsdClientDSWriteReq can be used to tally the number of
messages received by the PSD client.
This counter is incremented when the FIFO read/write
retransmission messages are sent to PSD server."::={ ciscoPsdClientStatistics 3}cPsdClientDSDiskFullTrans OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION
"The number of state transitions made by the PSD from
state 'disk available' to 'disk full'.
This counter is incremented when client receives the
disk full indication from PSD server."::={ ciscoPsdClientStatistics 4}-- Notification related objectscPsdClientNotifEnable OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"This object specifies whether the agent should
generate the notifications defined in this MIB module.
If the value of this object is 'true' it enables the
device to generate the notifications.
If the value of this object is 'false' it disables the
device from generating the notifications."DEFVAL{ false }::={ ciscoPsdClientNotifMgmt 1}--
--Configurations
--cPsdClientDSTable OBJECT-TYPESYNTAXSEQUENCEOF CPsdClientDSEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION
"A table consisting of entries for data-store(DS) and
auto-retrieval configurations.
In order to minimize the performance/memory impact on
the PSD client, as well as not to overwhelm the CG
with both live CDRs and retrieved CDRs, the maximum
retrieval rate from PSD server to GGSN is limited and
can be configured by the user."::={ ciscoPsdClientConfigurations 1}cPsdClientDSEntry OBJECT-TYPESYNTAX CPsdClientDSEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION
"Each entry contains the configuration for
auto-retrieval and also maximum retrieval value if
auto-retrieval is enabled."INDEX{ cPsdClientDSName }::={ cPsdClientDSTable 1}
CPsdClientDSEntry ::=SEQUENCE{
cPsdClientDSName SnmpAdminString,
cPsdClientDSAutoRetrieve TruthValue,
cPsdClientDSMaxRetrieve Integer32,
cPsdClientDSRowStatus RowStatus}cPsdClientDSName OBJECT-TYPE
SYNTAXSnmpAdminString(SIZE(1..32))MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This object contains the name of the configured
data-store"::={ cPsdClientDSEntry 1}cPsdClientDSAutoRetrieve OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-create
STATUScurrentDESCRIPTION"This object is used to enable/disable the CDR
auto-retrieval functionality.
If value of this object is set to 'true',
auto-retrieval is enabled.
If value of this object is set to 'false',
auto-retrieval is disabled."DEFVAL{ false }::={ cPsdClientDSEntry 2}cPsdClientDSMaxRetrieve OBJECT-TYPESYNTAXInteger32(1..6000)
UNITS"messages/minute"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"This object used to specify the maximum retrieval
value, when auto retrieve is enabled, i.e when the
value of the corresponding instance of
cPsdClientDSAutoRetrieve is set to 'true'."DEFVAL{60}::={ cPsdClientDSEntry 3}cPsdClientDSRowStatus OBJECT-TYPESYNTAXRowStatus
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The status of this conceptual row. This object is
used to create a row or delete a existing row in a
table."::={ cPsdClientDSEntry 4}cPsdClientDSServerTable OBJECT-TYPESYNTAXSEQUENCEOF CPsdClientDSServerEntry
MAX-ACCESSnot-accessibleSTATUScurrent
DESCRIPTION"The table contains the list of the PSD servers used to
write/retrieve the CDRs."::={ ciscoPsdClientConfigurations 2}cPsdClientDSServerEntry OBJECT-TYPESYNTAX CPsdClientDSServerEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This entry contains a description of the PSD server."INDEX{ cPsdClientDSName,
cPsdClientDSServerAddressType,
cPsdClientDSServerAddress }::={ cPsdClientDSServerTable 1}
CPsdClientDSServerEntry ::=SEQUENCE{
cPsdClientDSServerAddressType InetAddressType,
cPsdClientDSServerAddress InetAddress,
cPsdClientDSRetrieveOnly TruthValue,
cPsdClientDSServerRowStatus RowStatus}cPsdClientDSServerAddressType OBJECT-TYPESYNTAXInetAddressTypeMAX-ACCESSnot-accessible
STATUScurrentDESCRIPTION"This object indicates the type of Internet address of
the PSD server."::={ cPsdClientDSServerEntry 1}cPsdClientDSServerAddress OBJECT-TYPESYNTAXInetAddress(SIZE(4..20))MAX-ACCESSnot-accessibleSTATUScurrent
DESCRIPTION"The object specifies the Internet address of the PSD
server. The type of address of an instance of this object
is determined by the value of the corresponding instance
of cPsdClientDSServerAddressType."::={ cPsdClientDSServerEntry 2}cPsdClientDSRetrieveOnly OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The object represents that, the PSD server can be
configured either as write/retrievable or as
retrievable only.
If the value of this object is set to 'true', the PSD
server (the value of the corresponding instance of
cPsdClientDSServerAddress) shall not be used for
writing the CDRs.
If the value of this object is set to 'false', the PSD
server (the value of the corresponding instance of
cPsdClientDSServerAddress) shall be used for writing
the CDRs as well as retrieving the CDRs."::={ cPsdClientDSServerEntry 3}cPsdClientDSServerRowStatus OBJECT-TYPESYNTAXRowStatusMAX-ACCESSread-create
STATUScurrentDESCRIPTION"The status of this conceptual row. This object will
create a row or delete a existing row in a table."::={ cPsdClientDSServerEntry 4}--Notif infocPsdClientNotifDSServerAddrType OBJECT-TYPESYNTAXInetAddressTypeMAX-ACCESSaccessible-for-notifySTATUScurrentDESCRIPTION"This object indicates the type of Internet address of
the Data-Store server."::={ ciscoPsdClientNotifInfo 1}cPsdClientNotifDSServerAddress OBJECT-TYPESYNTAXInetAddressMAX-ACCESSaccessible-for-notifySTATUScurrentDESCRIPTION"This object specifies the Internet address of the
Data-Store server . The type of address of an instance
of this object is determined by the value of
cPsdClientNotifDSServerAddrType."::={ ciscoPsdClientNotifInfo 2}
--
-- Notification Definitions
--cPsdClientDownNotif NOTIFICATION-TYPEOBJECTS{
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}STATUScurrentDESCRIPTION"A notification of this type is generated when the
PSD server goes DOWN.
If the PSD client was in write/retrieving state, then
that operation shall be be stopped."::={ ciscoPsdClientMIBNotifs 1}cPsdClientUpNotif NOTIFICATION-TYPE
OBJECTS{
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}STATUScurrentDESCRIPTION"A notification of this type is generated when the
PSD server comes UP.
A GTP' path will be created fulfilling all the specific
requirements of the PSD interface."::={ ciscoPsdClientMIBNotifs 2}cPsdClientDiskFullNotif NOTIFICATION-TYPEOBJECTS{
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}STATUScurrentDESCRIPTION"A notification of this type is generated when the
PSD server's disk become full.
If the disk of writable PSD server becomes full, the
client shall not be able to write any CDR into the
server. It shall then behave as a retrieve only PSD
server."::={ ciscoPsdClientMIBNotifs 3}--
-- Conformances definitions
--cPsdClientMIBCompliances OBJECTIDENTIFIER::={ ciscoPsdClientMIBConform 1}
cPsdClientMIBGroups OBJECTIDENTIFIER::={ ciscoPsdClientMIBConform 2}-- compliance statementscPsdClientMIBCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for entities which implement
the CISCO PSD CLIENT MIB."MODULE--this moduleMANDATORY-GROUPS{ cPsdClientMIBStatisticsGroup,
cPsdClientMIBConfigurationsGroup,
cPsdClientMIBNotifGroup,
cPsdClientMIBNotifInfoGroup,
cPsdClientMIBNotifMgmtGroup
}OBJECT cPsdClientDSRowStatus
SYNTAXINTEGER{
active(1),
createAndGo(4),
destroy(6)}DESCRIPTION
"The states notInService(2), notReady(3) and
createAndWait(5) need not be supported."OBJECT cPsdClientDSServerRowStatus
SYNTAXINTEGER{
active(1),
createAndGo(4),
destroy(6)}DESCRIPTION"The states notInService(2), notReady(3) and
createAndWait(5) need not be supported."::={ cPsdClientMIBCompliances 1}
-- units of conformancecPsdClientMIBStatisticsGroup OBJECT-GROUPOBJECTS{
cPsdClientDSWriteReq,
cPsdClientDSReadReq,
cPsdClientDSRdWrRetrans,
cPsdClientDSDiskFullTrans
}STATUScurrentDESCRIPTION"A collection of objects providing Data Store
related statistics."::={ cPsdClientMIBGroups 1}
cPsdClientMIBConfigurationsGroup OBJECT-GROUPOBJECTS{
cPsdClientDSRowStatus,
cPsdClientDSAutoRetrieve,
cPsdClientDSMaxRetrieve,
cPsdClientDSServerRowStatus,
cPsdClientDSRetrieveOnly
}STATUScurrentDESCRIPTION"A collection of objects providing Data Store related
configurations."::={ cPsdClientMIBGroups 2}
cPsdClientMIBNotifGroup NOTIFICATION-GROUPNOTIFICATIONS{
cPsdClientDownNotif,
cPsdClientUpNotif,
cPsdClientDiskFullNotif
}STATUScurrentDESCRIPTION"A collection of Notifications."::={ cPsdClientMIBGroups 3}cPsdClientMIBNotifInfoGroup OBJECT-GROUPOBJECTS{
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}STATUScurrentDESCRIPTION"A collection of notification info objects on PSD."::={ cPsdClientMIBGroups 4}cPsdClientMIBNotifMgmtGroup OBJECT-GROUPOBJECTS{
cPsdClientNotifEnable
}STATUScurrent
DESCRIPTION"A collection of objects related with notification
management on PSD."::={ cPsdClientMIBGroups 5}END